home *** CD-ROM | disk | FTP | other *** search
/ Night Owl 6 / Night Owl's Shareware - PDSI-006 - Night Owl Corp (1990).iso / 049a / af_120.zip / AREAFIX.USE < prev    next >
Text File  |  1990-10-08  |  13KB  |  368 lines
  1.  
  2.  
  3.  
  4.  
  5.                            AreaFix v1.20 User's Guide
  6.                                 Jeffrey J. Nonken
  7.                                 19 September 1990
  8.  
  9.         ABOUT THIS DOCUMENT
  10.         ===================
  11.         This  document is public domain. Please note that this  does  not 
  12.         alter  the rights or ownership status of the copyright holder  of 
  13.         AreaFix in any way.
  14.  
  15.         This  is  a  user's  guide to AreaFix.  This  document  does  not 
  16.         describe how to install AreaFix; I created this document to allow 
  17.         echomail hubs running AreaFix to pass simple instructions  around 
  18.         to their downlinks.
  19.  
  20.         To  keep  things  simple  I  will  use  the  terms  "uplink"  and 
  21.         "downlink".  Your uplink is the system that is passing  echos  to 
  22.         you, usually from the direction of the backbone or the origin  of 
  23.         the  echo  (sometimes  known  as an "echo  feed").  You  are  his 
  24.         downlink.  If  you  are passing the echos  from  your  uplink  to 
  25.         another node, that node is your downlink, and you are his uplink. 
  26.         Simple?  Good. This guide assumes your uplink is running  AreaFix 
  27.         and tells you how to add and remove echomail areas remotely using 
  28.         AreaFix.
  29.  
  30.         WHAT IS AREAFIX?
  31.         ================
  32.         AreaFix  is a slick program that allows sysops to remotely  alter 
  33.         their  uplinks'  distribution files (AREAS.BBS,  ECHO.CTL,  etc.) 
  34.         without bothering the uplinks' sysops. In other words, if I  want 
  35.         to  pick  up a certain echo from my uplink, and  he  has  AreaFix 
  36.         installed,  I  just  send a special message and  the  linking  is 
  37.         handled  automatically. Ideally, my uplink's sysop  does  nothing 
  38.         once he has set up AreaFix.
  39.  
  40.         AREAFIX SETUP
  41.         =============
  42.         This  is  mostly  your Hub's responsibility. He  has  to  install 
  43.         AreaFix on his system and install your password. You should  pick 
  44.         a  password  to  use  in your  AreaFix  messages.  Remember  this 
  45.         password! It may be from 1 to 30 characters long and may  contain 
  46.         any printable characters except spaces.
  47.  
  48.         TALKING TO AREAFIX
  49.         ==================
  50.         To  invoke AreaFix you must send a netmail message to  your  Hub. 
  51.         The  message  should be private, addressed to  AreaFix,  and  the 
  52.         subject will be your password. Case is not important.
  53.  
  54.           To: AreaFix
  55.         Subj: Gronk
  56.  
  57.         AreaFix will also allow psuedonyms for itself. Your Hub may  have 
  58.         a  special name he wants you to send to instead of "AreaFix".  If 
  59.         so, he will tell you. For my examples I will use "AreaFix".
  60.  
  61.  
  62.                          AreaFix v1.20 User's Guide             page 1
  63.  
  64.  
  65.  
  66.  
  67.         AREAFIX TALKING TO YOU
  68.         ======================
  69.         Any  time AreaFix replies it will send you a  message  explaining 
  70.         what  action  it  took (if any) and giving you a  list  of  echos 
  71.         currently active for you. If you are first on your uplink's  list 
  72.         for  a  particular area -- which usually implies that you  are  a 
  73.         'feed' for that area, the originator of the echo -- AreaFix  will 
  74.         put  an asterisk next to the echo name with a note that says  you 
  75.         are  your uplink's feed for that echo. You will usually only  see 
  76.         that for local echomail areas, if at all.
  77.  
  78.         TURNING ON ECHOS
  79.         ================
  80.         Turning on an echo is easy; simply send a message to AreaFix with 
  81.         a  list  of echos you want. Case does not matter. The  names  may 
  82.         start  in  any  column, and you may string them  out  on  a  line 
  83.         (separated by spaces) or put them on separate lines.
  84.  
  85.            TO: AreaFix
  86.            FROM: Tom Slick
  87.            SUBJECT: Gronk
  88.  
  89.            Sysop
  90.            FDECHO
  91.            mtask
  92.            ---
  93.  
  94.         Notice Tom put a tear line at the end of his message. That's  the 
  95.         three  dashes on the line after "mtask". This tells AreaFix  that 
  96.         there is no more information for it in this message. If he wants, 
  97.         Tom may now write comments to his uplink Sysop, or just notes for 
  98.         himself. It's a good idea to add this tear line even if you  have 
  99.         nothing  more to say, in case some garbage gets tacked on to  the 
  100.         message during processing.
  101.  
  102.         AreaFix replies:
  103.  
  104.            TO: Tom Slick
  105.            FROM: Areafix on 1:103/522
  106.            SUBJECT: Re: Node change requests
  107.           
  108.                                 Additions/Deletions
  109.            AREA:                            STATUS:
  110.            -------------------------------  -------------------------------
  111.            SYSOP .........................  Added area.
  112.            FDECHO ........................  Added area.
  113.            MTASK .........................  Added area.
  114.                              Active areas on 1:103/522
  115.              USERS
  116.              C_ECHO
  117.              ORANGE_CO
  118.              ASIAN-AMERICAN
  119.              FDECHO
  120.              SYSOP
  121.  
  122.  
  123.                          AreaFix v1.20 User's Guide             page 2
  124.  
  125.  
  126.  
  127.              MTASK
  128.            Total found: 7
  129.            Note, a '*' indicates you're the feed on the echo.
  130.            --- Areafix v1.20
  131.  
  132.         TURNING OFF ECHOS
  133.         =================
  134.         Removing an area is just as easy; just preceed the area name with 
  135.         a minus sign (-) when you send the message.
  136.  
  137.            TO: AreaFix
  138.            FROM: Tom Slick
  139.            SUBJECT: Gronk
  140.  
  141.            -sysop
  142.            ---
  143.  
  144.         AreaFix replies:
  145.  
  146.            TO: Tom Slick
  147.            FROM: Areafix on 1:103/522
  148.            SUBJECT: Re: Node change requests
  149.            
  150.                                 Additions/Deletions
  151.            AREA:                            STATUS:
  152.            -------------------------------  -------------------------------
  153.            -SYSOP ........................  Deleted.
  154.                              Active areas on 1:103/522
  155.              USERS
  156.              C_ECHO
  157.              ORANGE_CO
  158.              ASIAN-AMERICAN
  159.              FDECHO
  160.              MTASK
  161.            Total found: 6
  162.            Note, a '*' indicates you're the feed on the echo.
  163.            --- Areafix v1.20
  164.            
  165.         Now Tom will no longer receive the Sysop echo.
  166.  
  167.         OPTIONS
  168.         =======
  169.         There  are  several useful options available. Each  of  these  is 
  170.         invoked  by  adding  a command to your  subject  line  after  the 
  171.         password. Note that any of these options can be disabled at  your 
  172.         uplink Sysop's discretion.
  173.  
  174.         -R is a rescan command. This causes AreaFix to force a rescan  of 
  175.         the echo area by removing the high-water mark. The next time  the 
  176.         area  is  scanned,  any messages in that area that  you  did  not 
  177.         receive  will be packaged up and sent to you. Note that  if  your 
  178.         uplink  has  an  area  as a passthrough, he  will  not  have  any 
  179.         messages to rescan.
  180.  
  181.  
  182.  
  183.  
  184.                          AreaFix v1.20 User's Guide             page 3
  185.  
  186.  
  187.  
  188.         -L  sends you a list of echo areas. The uplink Sysop may  make  a 
  189.         list  of available areas in a file; if he has done this,  the  -L 
  190.         command will cause AreaFix to send it to you.
  191.  
  192.         -Q  also sends you a list of echo areas. However, unlike  the  -L 
  193.         command, it will scan through the Area Control files to see  what 
  194.         areas  are available and send a list back in a  message.  AreaFix 
  195.         will  put  an  asterisk  (*)  next to  each  area  that  you  are 
  196.         receiving.
  197.  
  198.         There  is one thing to remember when using these  switches:  they 
  199.         may  not  work  unless there is some text in  your  message.  For 
  200.         example,  the -Q option will not send back a list if you  send  a 
  201.         blank message. However, just having the tear line will be enough.
  202.  
  203.            TO: AreaFix
  204.            FROM: Tom Slick
  205.            SUBJECT: Gronk -r -q
  206.  
  207.            Sysop
  208.            FDECHO
  209.            mtask
  210.            ---
  211.  
  212.         AreaFix replies:
  213.  
  214.            TO: Tom Slick
  215.            FROM: Areafix on 1:103/522
  216.            SUBJECT: Re: Node change requests
  217.            
  218.                                 Additions/Deletions
  219.            AREA:                            STATUS:
  220.            -------------------------------  -------------------------------
  221.            SYSOP .........................  Added area and rescanned.
  222.            FDECHO ........................  Added area and rescanned.
  223.            MTASK .........................  Added area and rescanned.
  224.                              Active areas on 1:103/522
  225.              USERS
  226.              C_ECHO
  227.              ORANGE_CO
  228.              ASIAN-AMERICAN
  229.              FDECHO
  230.              SYSOP
  231.              MTASK
  232.            Total found: 7
  233.            Note, a '*' indicates you're the feed on the echo.
  234.            --- Areafix v1.20
  235.  
  236.         In a separate message, AreaFix also replies:
  237.  
  238.            TO: Tom Slick
  239.            FROM: Areafix on 1:103/522
  240.            SUBJECT: Query request on 1:103/522
  241.  
  242.                  Areas available to 1:103/328 on 1:103/522:
  243.  
  244.  
  245.                          AreaFix v1.20 User's Guide             page 4
  246.  
  247.  
  248.  
  249.            * USERS
  250.            * MTASK
  251.            * C_ECHO
  252.              NEWOPUS
  253.              MEADOW
  254.            * ORANGE_CO
  255.            * SYSOP
  256.              HST
  257.              80XXX
  258.            * ASIAN-AMERICAN
  259.              BIBLE
  260.              CHATTER
  261.            * FDECHO
  262.              FLAME
  263.            * FOR-SALE
  264.              LAN
  265.              LASERPUB
  266.              STTNG
  267.            Total found: 18
  268.            Note: a '*' indicates you're already active for the echo.
  269.            --- Areafix v1.20
  270.  
  271.         ACCESS LEVELS
  272.         =============
  273.         When your uplink sets up your password, he will assign an  access 
  274.         level  to you. It is possible that he will have some  private  or 
  275.         special  interest echos that he does not want to  have  automated 
  276.         for AreaFix use. By assigning those areas a higher access than he 
  277.         gives to his downlinks, those downlinks will not be able to  turn 
  278.         on those areas remotely; the uplink sysop must enable those areas 
  279.         for  the  downlinks by hand. However, if you are  enabled  for  a 
  280.         restricted  area and you want to turn it off, you may do  so  via 
  281.         AreaFix as normal. The restriction is only one-way.
  282.  
  283.         POINTS AND POINTNETS
  284.         ====================
  285.         If  you  are  a  point off a bossnode you  may  have  a  slightly 
  286.         different situation than normal. Your bossnode probably  assigned 
  287.         you a private net number. Your software may address you as a node 
  288.         off that net or as a point off the bossnode, depending on how  it 
  289.         handles private nets and how you set it up. Let's assume for  the 
  290.         moment that you are set up as point 4 off private net 30010,  and 
  291.         that your bossnode's address is 1:103/522.
  292.  
  293.         If  you  are set up to use the privatenet address,  30010/4,  for 
  294.         everything,  then there is nothing to be aware of. Your  bossnode 
  295.         will  have  you  set up as 1:30010/4 and AreaFix  will  use  that 
  296.         number.
  297.  
  298.         If you are set up to use the point addressing scheme,  103/522.4, 
  299.         then your message editor and/or mailer must do the following:
  300.          - The  message must be addressed to your bossnode (103/522).  If 
  301.            your  bossnode  supports a privatenet AKA, you  can  send  the 
  302.            message to that address. (For example, 30010/0.)
  303.  
  304.  
  305.  
  306.                          AreaFix v1.20 User's Guide             page 5
  307.  
  308.  
  309.  
  310.          - The  message must be addressed as coming from your  bossnode's 
  311.            address (103/522).
  312.          - The message must have a MSGID or a FMPT kludge line, or both.
  313.  
  314.         When AreaFix sees the MSGID (which contains your full address) or 
  315.         the FMPT (which shows that you're a point off the address in  the 
  316.         message  header), and assuming your bossnode has AreaFix  set  up 
  317.         properly,  then  AreaFix will internally  convert  your  bossnode 
  318.         address plus point (103/522.4) into your point address  (30010/4) 
  319.         and process you normally.
  320.  
  321.         In  either case, your pointnet address (1:30010/4) will  show  in 
  322.         the AreaFix reply messages.
  323.  
  324.         Chances  are you won't have to change anything, but it's good  to 
  325.         know how things work in case something goes wrong.
  326.  
  327.         ACKNOWLEDGEMENTS
  328.         ================
  329.         Thanks  to  Greg Dawson for all the work he put into  making  the 
  330.         AreaFix utility, and for listening to suggestions from the users. 
  331.         AreaFix is certainly a utility you should not do without.
  332.  
  333.         Jeffrey J. Nonken
  334.         Ophiophile Maximus 
  335.         Fidonet: 1:273/715
  336.         Internet: Jeffrey.Nonken@f715.n273.z1.fidonet.org
  337.         BBS: (215)279-9799
  338.  
  339.  
  340.  
  341.  
  342.  
  343.  
  344.  
  345.  
  346.  
  347.  
  348.  
  349.  
  350.  
  351.  
  352.  
  353.  
  354.  
  355.  
  356.  
  357.  
  358.  
  359.  
  360.  
  361.  
  362.  
  363.  
  364.  
  365.  
  366.  
  367.                          AreaFix v1.20 User's Guide             page 6
  368.